Documentation to the delivery of XML-Definitions for the deliverers of SNB reports

Date: 19.9.2000, updated 21.9.2004 for version 2.00 of SNBreports.DTD-specification


In this Directory you find the following files:

readme.txt		this File
SNBReports-V001.dtd	the Data Type Definition (dtd) Version 0.01 for XML-Deliveries to SNB
SNBReports-V100.dtd	the Data Type Definition (dtd) Version 1.00 for XML-Deliveries to SNB
SNBReports-V200.dtd	the Data Type Definition (dtd) Version 2.00 for XML-Deliveries to SNB
ReportExample-V001.xml	a test example of a valid report (valid in the sense of DTD).
ReportExample-V200.xml	a test example of a valid report (valid in the sense of DTD).
FondReportExample-V200.xml	a test example of a valid report (valid in the sense of DTD).
xmlparser.exe		a validating parser for XML, to test your deliveries
xmlparserhelp.txt	a unix help file, somewhat strange to a windows-user
rpx.tar.gz		the original delivery of the xmlparser from the university of Edinburgh,
			Copyright by Richard Tobin, Language Technology Group, HCRC,
			University of Edinburgh. (can be found in the internet, of course)
console XML.lnk		a shorcut to the NT console, set to c:\ you must change the properties
			according to the directory, where you want to use the xmlparser
alltypeserror.xml	Example with errors:
			incompatible with DTD because anfoReports are mixed with simple and
			parametrized reports
mixingtypeserror.xml	Example with errors:
			within anfoReports, an nReport is not allowed



Explanations:

Starting as of spring 2005, three versions of SNBreport.DTD are valid:
	Version 1.00
	version 0.01	(identical to Version 1.00)
	version 2.00	anfoReports added
Please note, that version 2.00-reports will only be accepted in production around spring 2005



The SNBReports-V001.dtd and the ReportExample-V001.xml can easely been displayed using a simple
editor like Notepad.

When you deliver reports, you do not deliver the Datatype definition file, since this file
is declared in the dtd as a SYSTEM reference. (This reference must be exact, as is explained
in the dtd!). We urge you, to supply the reports with the extension ".xml". It is reasonable,
to name the file according to the supplier and referdate of the data contained in the file.

Example: 123456-000930.xml

where 123456 is your code (the tag subjectId in the dtd) and 000930 is the refer date.


We assume, that the first production version of the dtd will not differ from the now supplied
version 0.01, apart from the version number and the doctype reference, as explained in the
dtd. So, we think, that in the first few months of production, we will allow also delivery of
version 0.01 reports. But this depends on the experiences, which we gain in the next months
of testing.



Remarks about the delivered software and examples:

To check a report, you can write in a console prompt (Dos prompt):

	
....> xmlparser -VV  ReportExample-V001.xml

The parser will write all statements without errors in the Console Window. As soon as it detects
an error, it will stop with a corresponding error message. See the xmlparserhelp.txt for more
command line options of the parser.
(Please note, that the dtd, the xmlparser and the *.xml should be in the same folder,
to avoid problems).

For your own examples, please consult the SNBReports-V001.dtd, where the exact restrictions
of a valid SNBReport are defined and explained. Please do not change the SNBReports-V001.dtd,
since your report will be checked against exactly this dtd!

For any questions you can contact:

forms@snb.ch

If you want to supply your test reports to us, for verification, you can send the data by mail:

forms@snb.ch or dataexchange@snb.ch

First production reports will only be accepted by 2001. Please do not send these to the
addresses above!
